home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / max200_4.zip / OS2.DOC < prev    next >
Text File  |  1991-11-04  |  22KB  |  533 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                     Contents
  13.  
  14.  
  15.                   1  Introduction  . . . . . . . . . . . . . . . . . 1
  16.                   2  System Requirements . . . . . . . . . . . . . . 1
  17.                   3  Installation  . . . . . . . . . . . . . . . . . 2
  18.                   4  Maximus/2 and BinkleyTerm . . . . . . . . . . . 2
  19.                   5  Differences from DOS version  . . . . . . . . . 3
  20.                   6  Multiline Operation . . . . . . . . . . . . . . 5
  21.                   7  The MAXPIPE program . . . . . . . . . . . . . . 5
  22.                   8  The PMSNOOP program . . . . . . . . . . . . . . 6
  23.  
  24.                Index                                                 8
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.           1  Introduction
  32.  
  33.  
  34.           In  addition  to  all   the   features   mentioned  in  the  main
  35.           documentation,   Maximus/2 2.00 is different from version 1.00 in
  36.           the following ways:
  37.  
  38.                *    Version 2.00 uses MAXCOMM.DLL instead of COMM.DLL.  The
  39.                     Comm API is the same;  the DLL name was changed because
  40.                     of a conflict with another product.
  41.  
  42.                *    All  low-level  message  handling  code is contained in
  43.                     MSGAPI.DLL.  Maxp.exe and many other utilities use this
  44.                     code  (SILT,  SQUISH,  etc).  It is our hope that third
  45.                     party  developers  will  use  this  API/DLL  to  access
  46.                     messages,  rather than trying to do so directly.
  47.  
  48.  
  49.           2  System Requirements
  50.  
  51.  
  52.           Because OS/2 uses  virtual  memory  it  may  be  possible  to run
  53.           Maximus/2 with less than the  following configuration,  but it is
  54.           not recommended.
  55.  
  56.                *    OS/2  Version  1.20  or greater.  It may be possible to
  57.                     run Maximus/2 with earlier  versions  of  OS/2,  but it
  58.                     was not tested.
  59.  
  60.                *    Memory:    For  a  single  line  system  (one  copy  of
  61.                     Maximus/2 running),  you should have,  at  least,   the
  62.                     amount of memory recommended by your  version  of OS/2.
  63.                     For IBM OS/2 1.30,  this is 3MB.
  64.  
  65.                     As you add more phone  lines,    and/or  faster modems,
  66.                     you will have to increase  the amount of memory in your
  67.                     system if you want to prevent  file  transfer overruns.
  68.                     This is especially true if you have an 80286 processor.
  69.                     If  your  system  is  a  mail-only   system   (no  file
  70.                     transfers),  this may not be as large a concern.
  71.  
  72.                *    If using  an 80286,  you should have PROTECTONLY=YES in
  73.                     config.sys.   This prevents interrupts from being  lost
  74.                     by switching to real mode;   a very slow undertaking on
  75.                     that processor.   Even on an 80386 or I486,  if you are
  76.                     using high speed modems,   switching to the dos box may
  77.                     cause bytes to be lost (this will not be a concern with
  78.                     OS/2 2.00).
  79.  
  80.                *    Unless  there are very extenuating circumstances,   you
  81.                     should  leave the config.sys PRIORITY parameter set  to
  82.                     the  default  setting,  DYNAMIC.    By  setting  it  to
  83.                     ABSOLUTE,      you   turn   off    OS/2's   pre-emptive
  84.                     mutlitasking.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.                *    Maximus/2,  like all OS/2  RS232  software,    does not
  92.                     require  a  "FOSSIL"  driver.  OS/2,  unlike MSDOS,  is
  93.                     shipped with a  proper  device  driver  for  the serial
  94.                     ports.  The driver is called COM0x.SYS (where x = 1 for
  95.                     ISA    computers,        and   2   for   Microchannel).
  96.                     Unfortunately,  most (if not all) versions of OS/2 have
  97.                     shipped with a COM0x.SYS  file  that  is broken in some
  98.                     way.   Included  with  this  package are Gerry Rozema's
  99.                     (1:153/905)    COM16550.SYS and  COM16450.SYS  drivers.
  100.                     These are replacements for COM01.SYS,  and seem to work
  101.                     better than  the  standard  issue.    Both  drivers are
  102.                     contained in COM16550.LZH.
  103.  
  104.                *    HPFS is strongly recommended.  A ten-fold  (or greater)
  105.                     performance increase can be had if you have large *.MSG
  106.                     type messages areas.
  107.  
  108.  
  109.           3  Installation
  110.  
  111.  
  112.           Maximus/2  is  installed  the same way as Maximus/DOS,  using the
  113.           provided installation program  (INSTALL.EXE),  with the exception
  114.           that it should be installed from an OS/2 session,  not DOS.
  115.  
  116.           INSTALL will copy  3 DLLs (MSGAPI.DLL, MAXCOMM.DLL, SNSERVER.DLL)
  117.           to  your  C:\OS2\DLL  directory,    which  it  needs to  complete
  118.           installation.  These DLLs are  also copied to your Maximus system
  119.           directory.  After installation,    you may wish to erase the DLLs
  120.           copied to C:\OS2\DLL,  and add your Maximus  system  directory to
  121.           your LIBPATH in config.sys.  If you are at all unsure  about what
  122.           some  of the terms mentioned in  this  paragraph  (DLL,  LIBPATH,
  123.           CONFIG.SYS),  then do nothing.  Maximus should work as installed.
  124.  
  125.  
  126.           4  Maximus/2 and BinkleyTerm
  127.  
  128.  
  129.           Currently,   the only fidonet mailer  available  for  Maximus  is
  130.           BinkleyTerm.   This  section  discusses  running  Maximus/2  with
  131.           BinkleyTerm as the front end.
  132.  
  133.                *    BinkleyTerm *MUST* use the "BBS Spawn"  method  to load
  134.                     Maximus.  Furthermore,  you must start BinkleyTerm with
  135.                     the SHARE command line option ("BTP SHARE").  These two
  136.                     options cause Bink to  pass  the  opened COMM handle to
  137.                     Maximus.
  138.  
  139.                *    Maximus must be passed  the  FILE  HANDLE of the opened
  140.                     COM: port from binkley.    Using  the sample batch file
  141.                     (spawnbbs.cmd)  supplied  with  this document does this
  142.                     properly.  DO NOT try to hard code this value.  Passing
  143.                     a '1' for COM1: will NOT WORK!
  144.  
  145.  
  146.  
  147.  
  148.                                         - 2 -
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                *    ALL serial port  options (bps, parity, handshaking) are
  156.                     inherited  from  BinkleyTerm.    Maximus does not open,
  157.                     close, or alter the COMM parameters in any way,  except
  158.                     for  XON/XOFF  flow control. Therefore,    the  MAX.CTL
  159.                     "Mask  Handshaking"  statements  for  CTS  and  DSR  do
  160.                     nothing.  XON behaves as described.
  161.  
  162.                     NOTE:  Later versions  of  BinkleyTerm  may act in much
  163.                     the same fashion,  so it may be necessary  to  use  the
  164.                     "MODE COMx:" command to set up your port before loading
  165.                     BTP.
  166.  
  167.  
  168.           5  Differences from DOS version
  169.  
  170.  
  171.                *    In WFC (wait for  caller)  mode,   Maximus/2 only polls
  172.                     the keyboard about every 2 seconds.   Therefore, please
  173.                     be patient if you  hit  ALT-X  or  ALT-K, etc. This was
  174.                     done so that a negligible amount of CPU cycles are used
  175.                     while Maximus/2  is  waiting  for  the  phone  to ring.
  176.                     Modem responses are handled immediately.
  177.  
  178.                *    The "-p" command line option (which specifies  the port
  179.                     number under dos) specifies  file  handle  of  the comm
  180.                     port.  Binkley passes this open handle to SPAWNBBS.CMD,
  181.                     which in turn passes it to MAXP.EXE.  Do  not  try  and
  182.                     pass something like '-p1' for  COM1:,  '-p2'  for COM2:
  183.                     etc;  it will NOT work!
  184.  
  185.